9.2.4　使用Docker Compose部署应用

本节将实际部署9.2.3节介绍的 Compose 文件中定义的应用。读者可以从我的GitHub主页中的counter-app下载所需的文件 。

将Git库克隆到本地。使克隆下来的代码文件位于一个新创建的名为 counter-app 的目录中。该目录包含所需的所有文件，可以作为构建上下文。Docker Compose会使用目录名（ counter-app ）作为项目名称，这一点在后续的操作中会看到，Docker Compose 会将所有的资源名称中加上前缀 counter-app_ 。

进入 counter-app 目录中，检查文件是否存在。

$ cd counter-app
$ ls
app.py docker-compose.yml Dockerfile requirements.txt ...

简要介绍这几个文件。

• app.py 是应用程序代码（一个Python Flask应用）。
• docker-compose.yml 是Compose文件，其中定义了Docker如何部署应用。
• Dockerfile 定义了如何构建 web-fe 服务所使用的镜像。
• requirements.txt 列出了应用所依赖的Python包。

请根据需要自行查看文件内容。

app.py 显然是应用的核心文件，而 docker-compose.yml 文件将应用的所有组件组织起来。

下面使用Docker Compose将应用启动起来。以下所有的命令都是运行在刚才克隆的 counter-app 目录下的。

$ docker-compose up &
[1] 1635
Creating network "counterapp_counter-net" with the default driver
Creating volume "counterapp_counter-vol" with default driver
Pulling redis (redis:alpine)...
alpine: Pulling from library/redis
1160f4abea84: Pull complete
a8c53d69ca3a: Pull complete
<Snip>
web-fe_1  |  * Debugger PIN: 313-791-729

启动应用将花费几秒钟时间，其输出也非常详尽。不过关于启动过程会在稍后介绍，我们首先讨论一下 docker-compose 命令。

常用的启动一个Compose应用（通过Compose文件定义的多容器应用称为“Compose应用”）的方式就是 docker-compose up 命令。它会构建所需的镜像，创建网络和卷，并启动容器。

默认情况下， docker-compose up 会查找名为 docker-compose.yml 或 docker-compose.yaml 的Compose文件。如果Compose文件是其他文件名，则需要通过 -f 参数来指定。如下命令会基于名为 prod-equus-bass.yml 的Compose文件部署应用。

$ docker-compose -f prod-equus-bass.yml up

使用 -d 参数在后台启动应用也是常见的用法，代码如下。

docker-compose up -d
--OR--
docker-compose -f prod-equus-bass.yml up -d

前面的示例命令在前台启动应用（没有使用 -d 参数），但是使用了 & 将终端窗口返回。这种用法不太正规，所有的日志还是会直接输出到我们后续可能会用的终端窗口上。

这样应用就构建并启动起来了，读者可以直接使用 docker 命令来查看Docker Compose创建的镜像、容器、网络和卷。

$ docker image ls
REPOSITORY          TAG         IMAGE ID    CREATED         SIZE
counterapp_web-fe   latest      96..6ff9e   3 minutes ago   95.9MB
python              3.4-alpine  01..17a02   2 weeks ago     85.5MB
redis               alpine      ed..c83de   5 weeks ago     26.9MB

可以看到有3个在部署过程中构建或拉取的镜像。

counterapp_web-fe:latest 镜像源自 docker-compose.yml 文件中的 build: . 指令。该指令让Docker基于当前目录下的Dockerfile来构建一个新的镜像。该镜像基于 python:3.4-alpine 构建，其中包含Python Flask Web应用的程序代码。更多信息可以通过查看 Dockerfile 的内容进行了解。

FROM python:3.4-alpine                  << 基础镜像
ADD . /code                             << 将app复制到镜像中
WORKDIR /code                           << 设置工作目录
RUN pip install -r requirements.txt     << 安装依赖
CMD ["python", "app.py"]                << 设置默认启动命令

为了方便理解，每一行都添加了注释。部署时要删除掉。

请注意，Docker Compose会将项目名称（ counter-app ）和Compose文件中定义的资源名称（ web-fe ）连起来，作为新构建的镜像的名称。Docker Compose部署的所有资源的名称都会遵循这一规范。

由于Compose文件的 .Services.redis 项中指定了 image: "redis:alpine" ，因此会从Docker Hub拉取 redis:alpine 镜像。

如下命令列出了两个容器。每个容器的名称都以项目名称（所在目录名称）为前缀。此外，它们还都以一个数字为后缀用于标识容器实例序号——因为Docker Compose允许扩缩容。

$ docker container ls
ID    COMMAND            STATUS     PORTS                    NAMES
12..  "python app.py"    Up 2 min   0.0.0.0:5000->5000/tcp   counterapp_web-fe_1
57..  "docker-entry.."   Up 2 min   6379/tcp                 counterapp_redis_1

counterapp_web-fe 容器中运行的是应用的Web前端。其中执行的是 app.py ，并且被映射到了Docker主机的 5000 端口，稍后会进行连接。

如下的网络和卷列表显示了名为counterapp_counter-net的网络和名为counterapp_counter-vol的卷。

$ docker network ls
NETWORK ID     NAME                     DRIVER    SCOPE
1bd949995471   bridge                   bridge    local
40df784e00fe   counterapp_counter-net   bridge    local
f2199f3cf275   host                     host      local
67c31a035a3c   none                     null      local
$ docker volume ls
DRIVER    VOLUME NAME
<Snip>
local     counterapp_counter-vol

应用部署成功后，读者可以用Docker主机的浏览器连接 5000 端口来查看应用的运行效果，如图9.1所示。

单击浏览器的刷新按钮，计数会增加。感兴趣的读者可以查看 app.py 是如何在Redis中存储计数的。

如果使用 & 启动应用，那么可以在终端窗口中看到包含HTTP响应码200的日志。这表明请求收到了正确的响应，每次加载页面都会有日志打印出来。

web-fe_1 | 172.18.0.1 - - [09/Jan/2018 11:13:21] "GET / HTTP/1.1" 200 -
web-fe_1 | 172.18.0.1 - - [09/Jan/2018 11:13:33] "GET / HTTP/1.1" 200 -

恭喜！到此为止，多容器的应用已经借助Docker Compose成功部署了。